|
This page last changed on Jan 09, 2007 by bob.swift@charter.net.
RSS feed macro embeds an RSS feed on a page. It can display the contents of external feeds, or internal feeds generated by Confluence. To display blog posts or list recently updated pages in a space, use the Feed Builder to create an internal feed, then render it using this macro. RSS feeds are updated every hour.
Usage
Use the Wiki Markup Editor to edit the page and insert the RSS macro with your feed link.
Public Feeds
Replace the example
http://www.example.com/rss/
feed link below with your own
{rss:url=http://www.example.com/rss/}
Private Feeds with HTTP Basic Authentication
Private feeds are only accessible to users that are logged in. To view a private feed, you will need a login for the site. Append your username, for example user123 with password pa55w0rD onto the feed URL by pasting ?os_username=user123&os_password=pa55w0rD onto the end. To access a private feed
{rss:url=http://www.example.com/rss/?os_username=user123&os_password=pa55w0rD}
Private Feeds with HTTPS/SSL
HTTPS-protected feeds for external sites cannot be accessed from Confluence. To request this, please vote for HTTPS-enabled RSS Feeds. You may need to create a login first.
If your Confluence site has HTTPS enabled for all content, you can only access an internal RSS feeds after Making Internal HTTPS Feeds Accessible.
Optional Parameters
| Number |
Parameter |
Default |
Description |
| 1 |
max |
15 |
Limit the number of entries displayed |
| 2 |
showTitlesOnly |
false |
Show only the RSS feed titles |
| 3 |
titleBar |
true |
Hide the feeds titlebar |
The effects of these parameters are described below.
1. Limit the number of entries displayed
This parameter defaults to '15'.
2. Show only the RSS feed titles.
This parameter defaults to 'False'.
3. Hide the feeds titlebar
This parameter defaults to 'True'.
Working Example
This was rendered using the wiki markup
{rss:url=http://www.abc.net.au/news/syndicate/breakingrss.xml|max=5|showTitlesOnly=true}
Enabling Feed Caching For Faster Pages
This requires the installing the Cache Macro. To enable caching:
- Install the Confluence Repository Client into Confluence.
- Once setup, use the Confluence Repository Client plugin page to install the "Scripting Plugin" and "Utilities Plugin".
- For each RSS macro that you wish to cache, surround your RSS Feed call with a Cache macro call. To caching feeds for 60 minutes:
{cache:refresh=60m}
{rss:url=http:{cache}
As the page will not display feed updates until the cached version is refreshed, you may like to customise the cache behaviour.
Accessing Internal HTTPS Feeds
This only applies to Confluence instances which have enabled HTTPS for all content. If your site is fully HTTPS, the RSS macro cannot access internal feeds. To enable the RSS macro to access internal feeds without affecting your HTTPS setup, enable local-only HTTP access:
- Shut down Confluence
- Use the SSL guide to re-enable HTTP access to Confluence. This means that Confluence will be accessible via both HTTP and HTTPS
- Insert a firewall rule to redirect all HTTP requests not from the Confluence server to the equivalent HTTPS URL. This ensures that users will only be able to access Confluence via HTTPS, as intended. If you have still left HTTP access for attachments enabled (to avoid the IE download bug) you must selectively enable those URLS as well
- Modify your Confluence RSS macro feed link to use the HTTP URL, and restart Confluence
Troubleshooting
Check out RSS Feed Troubleshooting And Tasks.
Related Topics
Subscribing to RSS Feeds within Confluence
Tracking Updates Overview
Working with Macros
Return to Confluence 2 Home
|
I am a bit confused as to how to make this function work within confluence.
Objective: display more than one rss news feeds from several spaces within wiki on one main landing page within wiki.
In other words, I am developing a main intranet landing space in Confluence. In the uppermost part of the page, I want to import news feeds from other spaces in Confluence. ex; "Announcements" "Company News" would be feeds from their associated space.
Here is what I am doing and the resulting output:
From space "Announcements"; go to Space Amin/Advanced/RSS Feeds and select the feed I want - in this case it would be "new news posts". I get a pop-up where I can either choose "Save to disk" or "Open with". If I save to disk, I get a file on my desktop called "creatorsfeed.action" and have no clue how to use this. From documentation I have read and other feeds I have been able to import, I am supposed to see something like [http://rss.cnn.com/rss/cnn_tech.rss] - where I would then put on my page like this [rss:url=http://rss.cnn.com/rss/cnn_tech.rss\]. On the otherhand, if I choose the "Open with" option, I get a notepad full of code that again, does resemble the above rss link.
So has anyone tried this wth any success? I would like to be able to give office admins, developers, sales, etc access to post the latest news and have it show up on the main Intranet (Confluence) space.
I am running Confluence 2.2.6a if thatmakes any difference.
Thanks
-J

Posted by jalvarez@hi5.com at Oct 12, 2006 22:05
|
|
I have problems displaying content of an RSS 1.0 feed, while a RSS 2.0 feed does work. Does the RSS Feed Macro only support RSS 2.0 ?

Posted by joost@claroquesi.info at Oct 23, 2006 02:38
|
|
I am working on a similar problem, and I can't get it to work using the link from the builder. What gives?

Posted by daletan at Dec 28, 2006 04:29
|
|